home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / files.fmt / userLog.man < prev   
Encoding:
Text File  |  1991-08-23  |  2.8 KB  |  133 lines

  1.  
  2.  
  3.  
  4. userLog                   File Formats                    userLog
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      /sprite/admin/userLog, /sprite/admin/lastLog  -  files  con-
  12.      taining information about user logins
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      Each time a user logs into a sprite host, the system records
  16.      information  about  the  login in two files.  Each record in
  17.      each file is a fixed-length ASCII string,  so  a  particular
  18.      record  may  be updated without the need to read and rewrite
  19.      all other records in the file.
  20.  
  21.      One file records information on a per-host basis, while  the
  22.      other records information about the last login of each user.
  23.      The per-host file, //sspprriittee//aaddmmiinn//uusseerrLLoogg, has one record for
  24.      each  ``port''  of  each host.  The ports are numbered, with
  25.      port 0 reserved for the console of each host and  ports  1-N
  26.      corresponding  to  rlogin  pseudo-devices 1-N.  The per-user
  27.      file, //sspprriittee//aaddmmiinn//llaassttLLoogg, has one record  per  registered
  28.      user, indexed by the userID in //eettcc//ppaasssswwdd.
  29.  
  30.      When a user logs in, the record for the user's last login is
  31.      updated  to show the new login.  The record for the host and
  32.      port into which the user logs in is updated  with  the  same
  33.      information.   When  the user logs out, the latter record is
  34.      invalidated to show no one is currently logged  in  on  that
  35.      port, but the record for last login is updated only when the
  36.      user logs in again.
  37.  
  38.      Each record contains the following information, separated by
  39.      white space:
  40.  
  41.      valid         Whether the entry  corresponds  to  a  current
  42.                    login.
  43.  
  44.      hostID        Host on which user logged in.
  45.  
  46.      portID        Port on this host on which user logged in.
  47.  
  48.      time          time at which user logged in, or 0 when record
  49.                    is invalidated.
  50.  
  51.      location      string indicating other host from which rlogin
  52.                    occurred, or empty.
  53.  
  54.      Although the information is stored in ASCII format, to  make
  55.      it  sharable  by  machines  with  different  byte orderings,
  56.      internally the user log is accessed via routines  that  con-
  57.      vert  between  ASCII  and an internal C structure.  Refer to
  58.      the documentation for the uulloogg library for information about
  59.      this structure.
  60.  
  61.  
  62.  
  63. Sprite v.1.0        Printed:  August 22, 1991                   1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. userLog                   File Formats                    userLog
  71.  
  72.  
  73.  
  74. SSEEEE AALLSSOO
  75.      ulog, db, login, finger
  76.  
  77. KKEEYYWWOORRDDSS
  78.      database, user log
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v.1.0        Printed:  August 22, 1991                   2
  130.  
  131.  
  132.  
  133.